package com.example.library.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.library.dto.BaseQueryRequest;
import com.example.library.entity.Category;

import java.util.List;

/**
 * 图书分类服务接口
 *
   */
public interface CategoryService extends IService<Category> {

    /**
     * 分页查询分类列表
     *
     * @param queryRequest 查询请求
     * @return 分页结果
     */
    IPage<Category> getCategoryPage(BaseQueryRequest queryRequest);

    /**
     * 获取所有启用的分类（树形结构）
     *
     * @return 分类树
     */
    List<Category> getCategoryTree();

    /**
     * 获取所有启用的分类（扁平列表）
     *
     * @return 分类列表
     */
    List<Category> getEnabledCategories();

    /**
     * 根据父分类ID获取子分类
     *
     * @param parentId 父分类ID
     * @return 子分类列表
     */
    List<Category> getChildCategories(Long parentId);

    /**
     * 创建分类
     *
     * @param category 分类信息
     * @return 是否成功
     */
    boolean createCategory(Category category);

    /**
     * 更新分类
     *
     * @param category 分类信息
     * @return 是否成功
     */
    boolean updateCategory(Category category);

    /**
     * 删除分类
     *
     * @param categoryId 分类ID
     * @return 是否成功
     */
    boolean deleteCategory(Long categoryId);

    /**
     * 批量删除分类
     *
     * @param categoryIds 分类ID列表
     * @return 是否成功
     */
    boolean batchDeleteCategories(List<Long> categoryIds);

    /**
     * 更新分类状态
     *
     * @param categoryId 分类ID
     * @param status 状态
     * @return 是否成功
     */
    boolean updateCategoryStatus(Long categoryId, Integer status);

    /**
     * 批量更新分类状态
     *
     * @param categoryIds 分类ID列表
     * @param status 状态
     * @return 是否成功
     */
    boolean batchUpdateCategoryStatus(List<Long> categoryIds, Integer status);

    /**
     * 检查分类名称是否存在
     *
     * @param name 分类名称
     * @param parentId 父分类ID
     * @return 是否存在
     */
    boolean existsByName(String name, Long parentId);

    /**
     * 检查分类是否有子分类
     *
     * @param categoryId 分类ID
     * @return 是否有子分类
     */
    boolean hasChildren(Long categoryId);

    /**
     * 检查分类是否有图书
     *
     * @param categoryId 分类ID
     * @return 是否有图书
     */
    boolean hasBooks(Long categoryId);

    /**
     * 获取分类统计信息
     *
     * @return 统计信息
     */
    Object getCategoryStatistics();

}